Amiga Tools 2/Amiga Tools 2.iso/tex/macros/source/base/yandytex.txt

Text File | 1995-03-15 | 13KB | 298 lines

             LaTeX installation instructions for Y&YTeX v1.1

                             1994 August 20

SUMMARY
=======

This file contains instructions for installing LaTeX2e for Y&YTeX v1.1
(either from DVIWindo's `TeX Menu' or from the DOS prompt).

Before reading this file, you should obtain the LaTeX2e distribution
---  from your nearest CTAN archive or on diskette from Y&Y, Inc. --
and read `install.txt', which explains how the LaTeX2e installation works.

This file describes:

 * How to save any old version of LaTeX.

 * How to configure LaTeX.

 * How to unpack the LaTeX distribution.

 * How to create the LaTeX format.

 * How to install the LaTeX files.

 * How to check the LaTeX installation.

 * What to do if you have any problems.

NOTE:   If you get the LaTeX2e diskette from Y&Y, Inc., then installation
        is particularly easy, since ready-made `format' files are included,
        and all the files are already unpacked.  You can save time and
        effort by using the installation procedure on the diskette.
        Please refer to the `readme.txt' file on that diskette for details.

SAVING ANY OLD VERSION OF LATEX
===============================

The installation instructions below for LaTeX2e are designed to *preserve*
your existing LaTeX 2.09 files.  That way you can drop back to LaTeX 2.09
in the unlikely event that some problem should crop up.  After a while,
when you are certain that everything is working to your satisfaction,
you can delete the old files to free up some disk space (see below).

The format file for LaTeX 2.09 is called `lplain.fmt' in the `fmt'
sub-directory of your `y&ytex' directory --- typically `c:\y&ytex\fmt'
(or wherever the environment variable TEXFORMATS points to).  This format
file will not be disturbed by the installation of LaTeX2e since the new
format file is called `latex.fmt'.

The style files for LaTeX 2.09 are in the `latex' sub-directory of your
`y&ytex' directory --- typically `c:\y&ytex\latex' (one of the directories
that the environment variable TEXINPUTS points to).  This directory will
not be disturbed by the installation of LaTeX2e --- the new files go in the
`latex2e' sub-directory instead.

Do the following if you want to be able to switch easily between LaTeX 2.09
and LaTeX2e.  Set the TEXINPUTS environment variable so the directory
with the LaTeX 2.09 files is listed *before* the directory with the new
LaTeX2e files.  For example:

        TEXINPUTS=c:\texinput;c:\y&ytex\latex;c:\y&ytex\latex2e

Then you can call LaTeX2.09 with the old `latex.bat' batch file (which
uses `&lplain' on the TeX command line), and you can call LaTeX2e
using  the new `latex2e.bat' batch file (which uses `&latex' on the TeX
command line).  DVIWindo's `TeX Menu' will list *both* the old `LaTeX'
(i.e. LaTeX 2.09) and the new `LaTeX 2e' formats.

Once you decide that you no longer need LaTeX 2.09, you can save a
bit of disk space.  Do the following:

(i)   delete `lplain.*' from the `fmt' sub-directory of the `y&ytex' directory;
(ii)  delete  all files in the `latex' sub-directory of the `y&ytex' directory;
(iii) remove the `LaTeX' entry in DVIWindo's `TeX Menu';
(iv)  delete the `latex.bat' batch file from your batch file directory.

CONFIGURING LATEX
=================

NOTE: You can pretty much ignore the rest of this file if you use the ready-
      made format files on the diskette from Y&Y!  Otherwise read on.

First of all, to run the installation procedure you need to set the TEXINPUTS
environment variable to include the directory with the LaTeX 2e source files---
or make it the current directory.  If you use the recommended directory you
can just set:

        TEXINPUTS=c:\y&ytex\latex2e

After running the installation procedure you need to add the `latex2e'
subdirectory of the `y&ytex' directory to the directory list in the
TEXINPUTS environment variable.  If you want to be able to switch easily
between the old LaTeX 2.09 and LaTeX2e, then add the `latex2e' directory
*after* the `latex' directory.  For example:

        TEXINPUTS=c:\texinputs;c:\y&ytex\latex;c:\y&ytex\latex2e

If you will *only* be using the new LaTeX2e, you can, of course, omit the
reference to the `latex' subdirectory.

NOTE: If you have a recent version of the Y&Y TeX system, then the
      environment variables are defined in the [Environment] section of
      `dviwindo.ini'. With an older system you insert code to set the
      environment variables in  your `autoexec.bat' file --- this takes
      effect when you next reboot.

You can run LaTeX2e from DVIWindo's `TeX Menu' --- by selecting `LaTeX 2e'
--- or direct from DOS.  In the latter case you can just use the existing
`tex.bat' batch file:

        tex &latex <source-file>

Or you may find it convenient to create a new `latex2e.bat' batch file.
To do this, just copy `latex.bat', and replace `&lplain' with `&latex'.

While LaTeX2e requires more TeX memory than LaTeX 2.09, there is no need
to do anything, since Y&YTeX's dynamic memory allocation automatically
only uses as much memory as is needed.

UNPACKING THE DISTRIBUTION
==========================

NOTE: If you get the LaTeX 2e diskette from Y&Y, you won't need to `unpack'
      the files. But if you do not have the unpacked distribution, read on.
      You have the `unpacked' distribution if you have the file `latex.ltx'.

Create a directory on your hard disk for the LaTeX2e source files
(Don't mix them up with other files, since you may want to delete some
again after installation in order to conserve disk space).  For example:

        mkdir c:\y&ytex\latex2e

Get the latest version of the distribution off your nearest CTAN site by
anonymous FTP (Or run the installation batch file on the LaTeX2e
distribution diskette to unzip the files into this directory).

Create an empty temporary directory (on a drive with at least a Megabyte of
free space).  Make that the current directory.  Next, set the environment
variable TEXINPUTS to include the directory with the new LaTeX2e source
files.  For example:

        TEXINPUTS=c:\y&ytex\latex2e

You will also need to supply a file with hyphenation patterns.  You can
do this either by copying the standard `hyphen.tex' file for English ---
or a hyphenation pattern file for another language --- to the current
directory, or by adding a directory (s.a. c:\y&ytex\latex) which contains
`hyphen.tex' to the list of directories in the TEXINPUTS environment variable.

Also make sure the environment variable TEXFORMATS points to the
`fmt' sub-directory of your `y&ytex' directory.  For example:

        TEXFORMATS=c:\y&ytex\fmt

You can create new TeX formats (i) directly from the `TeX Menu' in DVIWindo,
(ii) using the `initex.bat' batch file, or (iii) `manually' from the DOS
command line.  If you work from the `TeX Menu' or use the `initex.bat' batch
file, then most of the details of LaTeX2e format creation are automatically
taken care off.  In fact, the two steps "Unpacking the Distribution" and
"Creating the LaTeX format" are then combined into *one* operation, and you
need not deal with all the details.

For example, if you run ini-TeX from the `TeX menu' in DVIWindo, just enter
`LaTeX 2e' for `Format Name' and enter `latex' for `Format Source File' if
you are installing the final release of LaTeX2e.  The `initex.bat' batch
file which is called will take care of running ini-TeX *twice* --- once on
`unpack.ins', then on `latex.ltx' (or `unpack2e.ins' and `latex2e.ltx' in the
beta release version).  It will also copy the finished `format' file to the
`fmt' sub-directory of your `y&ytex' directory, and create a `LaTeX 2e' entry
in the `TeX Menu'

*       And that is all there is to it!

If you instead want to unpack the files `manually' from the DOS prompt,
run ini-TeX on the file `unpack.ins'.  Using the `tex.bat' batch file:

                tex -i unpack.ins

or call Y&YTeX directly:  c:\y&ytex\y&ytex -i unpack.ins

This may take some time --- on an old 486 it may take as long as 4--5 minutes.
You can speed the process up somewhat by choosing a temporary directory on a
RAM drive rather than a hard disk (and avoid reading the source files
directly from a diskette by copying them to a hard disk first).


CREATING THE LATEX FORMAT
=========================

NOTE: If you called ini-TeX form the `TeX Menu' in DVIWindo, then the format
      has already been created and saved, so nothing else need be done!
      Read on if you instead unpacked the files `manually'.

Running ini-TeX on the file `unpack.ins' creates a large number of files,
including `latex.ltx' (You also need to supply `hyphen.tex' with
hyphenation patterns --- see previous section).  To create the new LaTeX2e
format, now run ini-TeX on `latex.ltx'.  You can use the batch file
`tex.bat' again:

        tex -i latex.ltx

or call Y&YTeX directly:  c:\y&ytex\y&ytex -i latex.ltx

The resulting format file, `latex.fmt' should be copied to the
`fmt' sub-directory of your `y&ytex' directory.  For example,

        copy latex.fmt c:\y&ytex\fmt

You may also wish to copy `latex.log' to the `fmt' directory.

PUTTING THE FILES WHERE LATEX CAN READ THEM
===========================================

You also need to move the files created when ini-TeX ran on `undump.ins'
to a permanent home where TeX can find them.  Create a `latex2e'
sub-directory of your `y&ytex' directory.  For example:

        mkdir c:\y&ytex\latex2e

Then copy all of the files from the temporary directory to that new
directory.  For example:

        copy *.* c:\y&ytex\latex2e

Then add this directory to the list of directories in TEXINPUTS. For example:

        TEXINPUTS=c:\texinput;c:\y&ytex\latex;c:\y&ytex\latex2e

You have now installed LaTeX 2e!

CHECKING THAT THE INSTALLATION WORKED
=====================================

To check that the installation worked, run the new LaTeX2e on the file
`ltxcheck.tex'.  You can do this from DVIWindo's `TeX Menu' or from the
DOS prompt.

In the `TeX Menu' simply select `LaTeX 2e' and in the `Open File' dialog
navigate to `c:\y&ytex\latex2e\ltxcheck.tex' (or wherever you placed your
LaTeX2e source files).  Or, run Y&YTeX directly using `tex.bat':

        tex &latex ltxcheck

It is highly recommended that you run this test before going on!
The test file will check some basic features of your TeX setup and
either say they are OK or complain and say they are BAD.

After this, you may also wish to process `usrguide.tex' and print the
result, unless you have already done so (and perhaps `fntguide.tex').

PROBLEMS
========

If you have an older Y&Y TeX Package, then it will be set up for the
beta release file names.  In particular, the older batch file `initex.bat'
refers to `unpack2e.ins' and `latex2e.ltx' in the two calls to ini-TeX.
If you have the final release of LaTeX2e, then change these references to
`unpack.ins' and `latex.ltx'. And if your files are really old (1993 Dec)
and still refers to `latex2e.ins' then please change that to `unpack.ins'...

If you have other problems with the LaTeX installation, see the
`PROBLEMS' section in `install.txt'.

If `ltxcheck' produces a `BAD' message, you will typically be able to
figure out from the message what is wrong.  For example, you may not
have the environment variable TEXINPUTS set up to include the new
LaTeX2e files.  If it is not obvious what caused the `BAD' message,
then please consult the section on `ltxcheck' in `texpert.txt'.

WARNING:   When using fonts other than Computer Modern look out for
           font naming problems.  For example, with LucidaBright +
           LucidaNewMath, use the style option [kb] for Karl Berry names
           or [yy] for the actual font names with `lucidbr' style.

WARNING:   When using fonts other than Computer Modern look out for
           font encoding problems.  LaTeX2e directly supports only
           the old `TeX text' encoding (OT1 -- textext.vec), and the new
           `Cork' encoding (T1 -- tex256.vec).  Use `\input ansiacce' (for
           Windows ANSI) or  `\input stanacce' (for Adobe StandardEncoding).

If you have any problems not resolved by the above, please contact Y&Y at:

[e-mail]        (email)
[phone]                  (fax)
[phone]                  (voice)

Y&Y, Inc.
45 Walden Street                (snail mail)
Concord, MA, 01742, USA

--- Copyright 1994 (C) Y&Y, Inc. and the LaTeX3 project ---
---              All rights reserved.                ---